home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 4 / Gold Medal Software - Volume 4 (Gold Medal) (1994).iso / menuts / shell21.arj / SHELL.DOC < prev    next >
Text File  |  1994-02-15  |  39KB  |  1,032 lines

  1.  
  2.  
  3.  
  4.         ┌─────────────────────────────────────────────────┐
  5.         │                                                 │──┐
  6.         │                                                 │  │
  7.         │                                                 │  │
  8.         │                                                 │  │
  9.         │                                                 │  │
  10.         │               I C O N   S H E L L               │  │
  11.         │                                                 │  │
  12.         │                  Version  2.1                   │  │
  13.         │                                                 │  │
  14.         │             (c) 93/94  D.G. Sureau              │  │
  15.         │                                                 │  │
  16.         │                                                 │  │
  17.         │                     For AT                      │  │
  18.         │               80286 - 384 Kb RAM                │  │
  19.         │                     EGA/VGA                     │  │
  20.         │                                                 │  │
  21.         │                                                 │  │
  22.         │                                                 │  │
  23.         │                                                 │  │
  24.         │                                                 │  │
  25.         │                                                 │  │
  26.         │                                                 │  │
  27.         │                                                 │  │
  28.         │                                                 │  │
  29.         │                                                 │  │
  30.         │                                                 │  │
  31.         │                                                 │  │
  32.         └─┬───────────────────────────────────────────────┘  │
  33.           └──────────────────────────────────────────────────┘
  34.  
  35.  
  36.  
  37.               SUMMARY
  38.  
  39. About registration
  40. Overview
  41.  Features of Iconshell
  42. Installation
  43. Starting up IconShell
  44. Description of an icon
  45. To select and to view an icon
  46. To launch a program
  47. To change page of file icons
  48. Associating a command with a file
  49. To change drive
  50. The pull-down menu
  51. Showing disk directory
  52. To create an icon with the install command
  53. To add, modify, delete an icon
  54. The command field
  55. The program field
  56. Options and variables
  57. To select files the desktop displays
  58. To send directly DOS command
  59. Setup and colors
  60. To move icons
  61. To move or change size of a window
  62. Disk commands
  63. To quit IconShell
  64. Phantom filenames
  65. BOARD.EXE
  66. How to make a new desktop
  67. To read a text file
  68. How to create images for icons
  69. The BAT files
  70. About the graphical interface
  71. Annex I: Problems and often asked questions
  72. Annex II: Summary of command keys.
  73.  
  74.  
  75. About registration
  76.  
  77. The registered version as some improvements:
  78. +  Very  fast  loading of VGA or EGA screens for background.
  79. +  A  program to convert PCX pictures into this very fast and much com-
  80. pressed format for displaying background images.
  81. +  Using alternate file of images of icons. Several files of icons come
  82. with the registered package.
  83. + Of course, removing screen and references as a shareware  evaluation
  84. version.
  85. + A printed manual.
  86. + Free updates at any user request.
  87. An order form may be made by printing the LICENSE.FRM text file.
  88.  
  89.  
  90. OVERVIEW
  91.  
  92. IconShell    is      a   useful DOS interface that make good use of the
  93. power  of current computers to a  friendlier  access  to  softwares and
  94. commands.  The  keys  and  mouse usage is close to that of Windows (c),
  95. allowing using the two softwares but learning only one user interface.
  96.  
  97.  
  98. FEATURES OF ICONSHELL
  99.  
  100. - It displays software and command as icons.
  101. - Allows automatic installation into icons.
  102. - Store options and variables with filenames.
  103. -  Allows to associate icons together with two clicks, to launch a pro-
  104. gram with a file, or to execute a command with files.
  105. - File management at the menu: copy, format, and so on.
  106. -  A  directory  window  and a special added program to  easily sail in
  107. directories.
  108. - Function to search a file on a disk.
  109. - Built-in file viewer keyboard or mouse driven.
  110. - Displays content of ZIP or LZH archives.
  111. - and it remain a very short program with all these features.
  112.  
  113. Iconshell  displays the current disk directory either as icons or text,
  114. and  programs    can  be executed with the single click of the mouse on
  115. the icon or the filename.
  116. Automatic    installation of the filenames and their path is  also  al-
  117. lowed to run them further without the search in disk sub-directories.
  118.  
  119. Until    30  icons  can  sit on a desktop and each of them can store in
  120. data    fields  all DOS commands, filenames and following options  that
  121. are  typed  to  run a software. Complex line commands no longer require
  122. to  refer  at the manual, but once to install them. User can create un-
  123. limited number of desktops.
  124.  
  125. Some    commands    are  already installed, that are only examples, you
  126. can change them and add so much than you want.
  127.  
  128. Finally,  the  functions  of  IconShell,  are all these  you install in
  129. icons, including all DOS commands.
  130.  
  131. This   software  is  shareware, it can be freely copied and distributed
  132. by  vendors, users, sysops, but using it on his computer  more than the
  133. 15-DAYS trial requires payment of a user licence.
  134.  
  135.  
  136. INSTALLATION
  137.  
  138. Copy  first  the  files  of  the  archive on the disk or the hard drive
  139. unit.
  140. If  you want IconShell automatically load at the start-up of the compu-
  141. ter,  add  the  following  command on the last line of the AUTOEXEC.BAT
  142. file:
  143.  
  144.    SHELL.EXE  C:\SHELL.CFG
  145.  
  146. or SHELLR.BAT C:\SHELL.CFG
  147.  
  148.   The  second  syntax  is to have IconShell automatically reloaded when
  149. one quits a program that IconShell has load.
  150.  
  151. If  a  previous  version to 1.8 is already installed on the disk, erase
  152. first    all  older  files  of this version,to avoid compatibility pro-
  153. blems.
  154.  
  155. Once  installed,  change    the  content  of  icons to give files their
  156. full path  with  correct drive and dir.
  157. You    must  absolutely set  an exact path to the three desktop loading
  158. icons:  Shell,    Disk   command,  SW tools, and all future desktop you
  159. will create.
  160.  
  161. For example, the current content of the "Disk command" icon is:
  162.  
  163.   BOARD DISK.CFG
  164.  
  165. Change that to a full path, for example:
  166.  
  167.   BOARD C:\DISK.CFG
  168.  
  169. And  then,  you  can  move to any sub-directory and apply the disk com-
  170. mands to current sub-directory.
  171.  
  172. Program  that  have  their  path included in the definition of the PATH
  173. variable  in  AUTOEXEC.BAT  does  not need for a path definition in the
  174. con.  For example, all files in the directory DOS are always accessible
  175. if AUTOEXEC.BAT has a line as:
  176.  
  177.   PATH=C:\DOS;
  178.  
  179.  
  180. STARTING UP ICONSHELL
  181.  
  182. Type:   shell
  183.     or  shellr
  184.  
  185. It's better to specify the path of the desktop file:
  186.  
  187.    shellr c:\shell.cfg
  188.  
  189. If installed on the c: drive, type simply SE.
  190. SE.BAT returns  to the root directory of the c: disk, and load
  191. IconShell with  the SHELL.CFG desktop file as parameter.
  192.  
  193.  
  194. DESCRIPTION OF AN ICON
  195.  
  196. To    see   the data inside an icon, select it with the cursor keys and
  197. press  the  'v'  key.  A green  window  shows the title, the image, the
  198. command and program fields.
  199.  
  200. First    of    all, please to remember the difference between a command
  201. icon,  that is an installed icon with data fields, and a file icon that
  202. is a file displayed as icon on the desktop.
  203. When I say only 'icon' that refers to an installed icon.
  204.  
  205. An  icon    has  an  image and a title and has two data fields not dis-
  206. played on desktop:
  207. - the COMMAND field for DOS commands, and
  208. - the PROGRAM field for a program with his path and options.
  209.  
  210.  
  211. The  command  field gets DOS commands, which has to be executed without
  212. to  leave  IconShell, as  for example, a directory change before to run
  213. a program.
  214. It can also get a batch filename, a COM or EXE program.
  215.  
  216. When    one click on  an icon, IconShell always first performs the com-
  217. mand field, and then the program field.
  218.  
  219. The  program field  gets  the name of a program to run, with EXE or COM
  220. extension, and its options.
  221.  
  222. Here are two examples of data fields:
  223.  
  224. Example:           Title: Word x.x
  225.                    COMMAND: cd \word
  226.                    PROGRAM: word mytext.doc
  227.  
  228. Example:           Title: Unpack
  229.                    COMMAND:
  230.                    PROGRAM: \tools\unpack a: \(file.pak) -x2
  231.  
  232.  
  233. TO SELECT AND VIEW AN ICON
  234.  
  235. Use  the  cursor keys to move the cursor on an icon, then its title be-
  236. comes  highlighted, press ENTER to execute it, or type a command key to
  237. apply a function on this icon.
  238.  
  239. Using   a  mouse, move the mouse cursor on the image or the title of an
  240. icon, and  click once to select this icon, click again to execute it.
  241.  
  242.  
  243. TO LAUNCH A PROGRAM
  244.  
  245. Select  an  icon  and  press  ENTER  or click twice on the icon. If the
  246. program  needs  variables to be entered when one loads it, one be asked
  247. to  type then by a dialogue box. One may also click on the program name
  248. in the directory window to execute it.
  249.  
  250. Another    way  to give parameters is the association, that is detailed
  251. after the following chapter.
  252. Before  one  speaks  about  association, get clearly in mind the diffe-
  253. rence in the two methods:
  254. -  one  clicks  the  LEFT  mouse button or one presses ENTER to run the
  255. program displayed as icon.
  256. -  one  clicks  the RIGHT mouse button or one presses '+' to run a pro-
  257. gram  with  association  of one or more other icons of files as parame-
  258. ters.
  259.  
  260. When  the  program  one  has launched ends, one returns to DOS or Icon-
  261. Shell  is  reloaded, according to the chosen option. To return to Icon-
  262. Shell, two things are necessary:
  263. 1)  IconShell  must to have been loaded with the SHELLR command, either
  264. at the prompt line or by the AUTOEXEC.BAT file.
  265. 2)    The  option 'Reload IconShell' must to be set on, it is the first
  266. line in the setup window.
  267.  
  268. Sometimes,  to  return to IconShell is not desirable. Some programs mo-
  269. dify  the  timer  of the computer that change the time and date. Others
  270. erase  the  drivers  that  reside in memory. On must to boot the system
  271. after  these program, but it is very useful to reload automatically the
  272. DOS interface when one runs short programs often used.
  273.  
  274.  
  275. TO CHANGE PAGE OF FILE ICONS
  276.  
  277. When  one  move  the  mouse  pointer  on  the left or right side of the
  278. screen,  the  mouse  become an horizontal arrow. One click then to dis-
  279. play  a  previous  page of file icons that symbolically is at the left,
  280. or  the  next  page  that is at the right. The Page Up key to view next
  281. files,  and  Page  Down  key to view previous file do the same with the
  282. keyboard.
  283.  
  284.  
  285. TO ASSOCIATE A COMMAND AND A FILE
  286.  
  287. Commands  in    the  disk  sub-menu are performed on currently selected
  288. icon,  if  a  file  icon,  that  is a kind of association. One may also
  289. associate  an icon  that holds a command with variable filenames in pa-
  290. renthesis,  with  file  displayed  as icon on the desktop. The filename
  291. replace the string in parenthesis.
  292.  
  293. One   tags first the  command icon by a press on '+' key, then one tags
  294. one or more file icons by selecting them and pressing again '+'.
  295.  
  296. With  the  mouse, one clicks once on a command icon with the right but-
  297. ton  (the  mouse  pointer  become  a cross), and then one clicks on the
  298. icons of the file icons in order.
  299. When  one  has selected the first icon, its content is displayed at the
  300. bottom  of  the screen. And when on select the following icons, the re-
  301. placement of the strings in parenthesis appears simultaneously.
  302.  
  303. If  the  first  icon does not hold variables, the icon is simply selec-
  304. ted, nothing appears.
  305. When  all variables are replaced by filenames, the command is automati-
  306. cally performed.
  307.  
  308. Example: To load the program EDIT.EXE with the file TEXT.TXT:
  309.   The  installed  icon  EDIT  must  have  a  variable  in  parenthesis,
  310. as for example:   EDIT (file)
  311.   Select the installed icon EDIT, press '+', then select  the file icon
  312. TEXT, press '+' again.
  313.     EDIT (file) is replaced by EDIT TEXT.TXT... and the command is per-
  314. formed.
  315.  
  316. Example: An icon holds the command  CD \(dir)
  317.   Selects  this  icon and press '+', the command  will be  displayed at
  318. the  bottom  of  the  screen.  Then select an icon of a directory, 'my-
  319. dir',   for example, and press '+' again:  CD \mydir  will then be dis-
  320. played, IconShell and the directory change is processed.
  321.  
  322.  
  323. TO CHANGE DRIVE
  324.  
  325. At  bottom  left  of  the  screen,  icons figure each available logical
  326. unit.    Logical  unit is all that MS-DOS recognizes as unit, including
  327. the pseudo B drive, virtual disks, and SUBST commands.
  328. To  change  the  unit click on an icon or press SHIFT and the letter in
  329. uppercase.
  330.  
  331. The  B  unit  is  always displayed, if  here is no physical second disk
  332. drive  present,  MS-DOS  creates a logical B unit and redirects the ac-
  333. cesses to the physical drive A.
  334. You can yourself define logical unit by using the SUBST command.
  335. For example:   SUBST E: C:\WORK
  336. IconShell displays then an E disk icon.
  337.  
  338.  
  339. THE PULL DOWN MENU
  340.  
  341. To access the menu, hold down the ALT key and press a key among F,
  342. I, O, D, U. These letters are underlined on the menu bar.
  343. Press ENTER or the down cursor key to display a sub-menu.
  344. Use cursor keys to move the selection bar or to change sub-menu.
  345. Press ENTER to execute the command. If this command must apply to
  346. an icon, it will apply to the currently highlighted one.
  347.  
  348. Each  option    has  a shortcut key, that is either underlined or shown
  349. at the right.
  350. Press ESC to quit the sub-menu or the menu.
  351.  
  352. Using mouse:
  353. Do  a  mouse click on the menu bar to active it, click on a line of the
  354. sub-menu to execute the function.
  355.  
  356. There are three buttons on the title bar.
  357. - The leftmost button is for displaying the version number,
  358. -  the second at left that shows a double arrow toggles between icon or
  359. directory display,
  360. -  the one at right, that shows a diamond, replaces the ESC key for the
  361. mouse.
  362.  
  363. Summary of pull-down menu command:
  364.  
  365. Files
  366.  Directory:    Display the current directory.
  367.  Run:          Execute an icon.
  368.  Board mask:   Select files to display on the desktop: EXE,  COM, BAT,
  369.                dir or data (all others).
  370.  Dos command:  Execute directly DOS commands.
  371.  Save config:  Save changes made on display (changes on resident
  372.                icons are automatically saved).
  373.  About...      Display copyright, current version and date.
  374.  Exit:         Return to DOS.
  375.  
  376. Icons
  377.  View:         Display fields of a resident icon.
  378.  Install:      Create a resident icon from a file icon.
  379.  Add:          Opens a dialog box for resident icon creation.
  380.  Change:       Change fields/image of a resident icon.
  381.  Delete:       Remove an installed icon of the board (not
  382.                the files).
  383.  Move:         Reorganize the desktop.
  384.  
  385. Options
  386.  Help:         List essential commands.
  387.  Setup:        Change configuration.
  388.  Colours:      Open the window for preferences setting.
  389.  Std desktop:  Retrieve all defaults: colours, window sizes,
  390.                etc...
  391.  
  392. Disk
  393.  Lock file     Protect a file against deletion.
  394.  Rename        Rename currently selected, highlighted, file or
  395.                directory of move it on the same disk.
  396.  Make dir      Create a new sub-directory.
  397.  Del           Delete the highlighted file or directory if empty.
  398.  Copy          Copy a file or a directory and sub-directories.
  399.  Disk copy     Copy a disk.
  400.  Format        Format a disk.
  401.  
  402.  
  403. Utilities
  404.  Where is      Search for a filename or pattern anywhere on
  405.                a given drive.
  406.  Read file     Display a text file.
  407.  
  408.  
  409. SHOWING THE DISK DIRECTORY
  410.  
  411. The  'd'  command    allows  a larger disk directory list that is dis-
  412. played  as  text  inside  a window. Filenames have uppercase black let-
  413. ters, and sub-directories red small letters.
  414. Files  are  displayed  according  to mask specified by the mask setting
  415. and  this  is  displayed  as gray or yellow squares on the window title
  416. bar.
  417. When  there  are  yellow the file having this extension are included in
  418. the list. Simply click on the squares to change the setting.
  419. The shortcut keys are these:
  420. - e: for EXE files.
  421. - c: for COM files.
  422. - b: for BAT files.
  423. - t: for all other files.
  424. - d: for directories.
  425.  
  426. Other commands in the directory window:
  427. - ESC: exits, returns to board of icons.
  428. - cursor keys, to select or scroll.
  429. - ?: Display more info: show file size and date, press ? again
  430.      to return to condensed display.
  431. - i: install the file into an icon.
  432. - r: view the file.
  433. - A..F (uppercases) change drive.
  434. - CURSOR KEYS: select a filename or scroll.
  435. - ENTER: acts on the highlighted entry,
  436.    > if a directory, performs a change dir.
  437.      The '..' sub-directory returns to previous level.
  438.    > if a program (EXE, COM, BAT), runs it.
  439.    > if an archive (ZIP or LZH), displays it's content.
  440.      Press ENTER again to return to directory.
  441.    > otherwise, ENTER calls the file viewer.
  442. -    ALT-SPACE: open the menu, then use cursor to move or to change the
  443. size.
  444.  
  445. Using  mouse,  click  once on an entry to select it, or use the lift at
  446. the  right  of the window, and click twice to replace 'ENTER'. To exit,
  447. do a mouse click out of the window.
  448.  
  449. This function shows up to 256 file or directory names.
  450.  
  451.  
  452. TO CREATE AN ICON WITH THE INSTALL COMMAND
  453.  
  454. Installation  avoids  to   search a program in a sub-directory, and al-
  455. lows to put the options at command line if required.
  456.  
  457. Move  the    cursor    on  the file icon on the desktop and type 'i'. A
  458. dialog  box  displays the content of the future resident icon when ins-
  459. talled:
  460. - title, that is the node of the filename,
  461. - a change drive and directory command,
  462. - the program name.
  463. You may edit these data now. Press ESC to cancel.
  464.  
  465.  
  466. TO ADD, MODIFY, DELETE AN ICON
  467.  
  468. To  add  a  new  Icon,  press 'a'. A dialog box will appears. This  box
  469. shows  an image of icon that is the first in buffer, you may choose the
  470. image with the PAGE UP/DOWN keys.
  471.  
  472. To  change   line,  use the up/down cursor keys. Don't press ENTER when
  473. a  field  is  filled.    All  that  is  on  the  screen  is also in the
  474. memory,  and  the ENTER key serves to save data and to close the dialog
  475. box...  One  may  also click  on  the  'Get' button to save and quit. O
  476. one may press ESC or click on the Cancel button.
  477.  
  478. The  title  can  be  16 letters long, other fields have size limited by
  479. the  window  width,  and they are specially described in the two follo-
  480. wing paragraphs.
  481.  
  482. The  windows  can    be  enlarged by a press on the ALT-SPACE key, or a
  483. mouse  click  on  the  borders (See later for details of that).
  484.  
  485.  
  486. To  modify an existing icon, the    command   is:  'c'. Then, there  is
  487. no difference with the 'add' or 'install' function.
  488.  
  489. To  delete  an  installed icon, press  DEL,  and  confirm  by  a  press
  490. on  the 'y' key or a mouse click on the Ok button. To cancel, press 'n'
  491. or ESC or click on the Cancel button.
  492.  
  493.  
  494. THE COMMAND FIELD
  495.  
  496. This  field gets any DOS command as typed on the DOS line command.
  497. Starting  MS-DOS  version   5, one can chain several commands separated
  498. by '|' symbol.
  499. If  the   field remains  blank, the program ignores it when the icon is
  500. selected.
  501. A  batch  filename (BAT), a program with COM or EXE extension are valid
  502. commands.
  503. One  must  verify  than the process  will  not  have memory action that
  504. can  erase IconShell, as it remains in memory when the COMMAND field is
  505. performed.
  506. The  program must run  in  on remaining memory, that is 400-500k accor-
  507. ding to the configuration.
  508.  
  509. If  the command uses variable data, put a string in parenthesis for re-
  510. placing  at  the  execution time or for association.  When one click on
  511. the  icon  with the left mouse button, IconShell opens a dialog box the
  512. the  replacement  of the string, when one clicks with the right button,
  513. IconShell  wait  for one click on an icon of file, and it makes the re-
  514. placement of the string by the filename with the path.
  515.  
  516.  
  517. THE PROGRAM FIELD
  518.  
  519. The  program    field  gets  a  program name with 'EXE', 'COM' or 'BAT'
  520. extension. One may set the path of the file.
  521.  
  522. This   field  can  remain  blank if the icon represents only a DOS com-
  523. mand.
  524. The program  name (but BAT file) can be followed by several parameters
  525. until  a  maximum  of  7, separated by a space. The first parameter can
  526. be  separated  of the name by '/', if this is a correct syntax for this
  527. program.
  528.  
  529. Example, to execute Windows in standard mode:       win/s
  530.  
  531. The  program field as the command field allows string to replace at the
  532. execution time.
  533.  
  534. Including  substituting strings the fields can be  until 160 characters
  535. long.
  536.  
  537.  
  538. OPTIONS AND VARIABLES
  539.  
  540. Some  programs  as PKUNZIP, LHA, can have many parameters including fi-
  541. lename  that  change each time, so to avoid often to type their complex
  542. syntax, IconShell allows  strings to replace that are in parenthesis.
  543.  
  544. When the icon will be performed, IconShell will ask for replacement.
  545.  
  546. a) Example of replacement for the command fields.
  547.  
  548.          COMMAND: cd \(directory)
  549.  
  550. When one does a mouse  click on this icon a message is displayed:
  551.  
  552.          Replace or press ENTER to keep
  553.          directory.....................
  554.  
  555. If  one types for example, 'windows', the string is replaced and paren-
  556. thesis are removed,  that will produce the following result:
  557.  
  558.          cd \windows
  559.  
  560. If  one presses only ENTER, the string that is the default remains, and
  561. this produces:
  562.  
  563.          cd \directory
  564.  
  565. b) Example of replacement for the program field.
  566.  
  567.          PROGRAM: unpack -t a:(SOURCE) (DESTINATION)
  568.  
  569. At the click on the icon, IconShell asks:
  570.  
  571.          Replace or press ENTER to keep
  572.          SOURCE........................
  573.  
  574. Type for example:
  575.  
  576.          MEGAPROG.PAK..................
  577.  
  578. IconShell then asks:
  579.  
  580.          replace or press ENTER to keep
  581.          DESTINATION...................
  582.  
  583. Type for example:
  584.  
  585.          c:\temp.......................
  586.  
  587. Substitutions will produce the following result:
  588.  
  589.          unpack -d a:MEGAPROG.PAK c:\temp
  590.  
  591.  
  592. TO SELECT FILES THE DESKTOP DISPLAYS
  593.  
  594. Press the 'b' key to access the dialog box.
  595. Press  in    order  'e',  'c',  'b',  't', 'd' to select/deselect files
  596. with  EXE, COM, BAT extension, others files or directories. Press ENTER
  597. to exit.
  598.  
  599.  
  600. TO SEND DIRECTLY DOS COMMANDS
  601.  
  602. Press 'o', and type a DOS command in the dialog box.
  603.  
  604.  
  605. TO MOVE ICONS
  606.  
  607. Press  'm'. The title  of the current icon is now displayed with a yel-
  608. low  background.  Move  the  icon selection bar with the cursor keys to
  609. a  new location, and press 'm' again or press ENTER, the icon will move
  610. to this new location.
  611. With the mouse, select an icon and click on the 'move' option in the
  612. pull-down menu, and repeat to move, or click on the ESC key at right
  613. of the title bar to cancel.
  614.  
  615.  
  616. SETUP AND COLORS
  617.  
  618. Type 'u' to open the setup dialog box.
  619.  
  620. Following option may be changed:
  621.  
  622. Automatically return to IconShell
  623.  Type 'a' to switch the selection.
  624.   The  automatic  reload  work  only  if IconShell has been load by the
  625. SHELLR command.
  626.  
  627. Screen resolution.
  628.  The desktop may have two screen resolutions:
  629. - the medium resolution, or EGA, or VGA 16.
  630. - the high resolution or VGA 18, 640 x 480 pixels.
  631.   Press  's' to change this option. The high resolution allows until 30
  632. installed  icon,  and  one  may  not switch to the medium resolution if
  633. more than 20 icons are created.
  634.  
  635. Background picture
  636. The  registered  version  allow display of an VGA or EGA 16 colors pic-
  637. ture  as background. Press the 'p' key to select/deselect the disof the
  638. picture. That can also be done from the desktop.
  639.  
  640. Display of current path and available disk space.
  641.  Press 'f' to change.
  642.  
  643. Display file icon on the remaining space on the desktop.
  644.  Press 'i' to change.
  645.  
  646. Display either installed icons or file icons only.
  647.  Press 'o' to change.
  648.  From the desktop press SPACE to change.
  649.  
  650.  
  651. TO CHANGE THE COLORS
  652.  
  653.   To  change  the  colors  of the desktop, press the F5 key to open the
  654. dialog  box, then select an item  with  the TAB key or vertical arrows,
  655. and  click  on  a  color or use the horizontal arrows cursor to move to
  656. the chosen color.
  657.  To set the background either dark or light, press the 'b' key.
  658.  Press ENTER to keep the changes and exit.
  659.  
  660.   Title    bar  and  background of windows can be changed, when opened,
  661. with  ALT-b  and    ALT-h or by opening the window menu with ALT-SPACE,
  662. and then with the 'b' or 'h' commands.
  663.  
  664.   To  restore  all defaults press 'z'. All  changes relating to display
  665. will  be  cleared  and the initial  desktop  restored. Changes on icons
  666. are  preserved however. To forget  all changes including  icons,  erase
  667. the file SHELL.CFG, it will be rewritten with default icons.
  668.  
  669.  
  670. TO MOVE OR CHANGE SIZE OF A WINDOW
  671.  
  672.   If  the  window has a button with a 'w' letter in the upper left cor-
  673. ner,  it  has  a  system menu than holds the 'move' and 'size' options,
  674. one  presses  ALT-SPACE to get the menu. If the window doesn't have the
  675. button,  to  press  ALT-SPACE goes directly to the move/size mode and a
  676. dotted rectangle appears.
  677.   With  the  mouse,  if  to move  is  allowed, the mouse cursor becomes
  678. four  arrows  when  the  mouse  stays  on the left or top border of the
  679. window.
  680.   If  to  change  the  size of a window is allowed,  a horizontal arrow
  681. replaces  the  standard  arrow    when   the mouse pointer stays on the
  682. right  or  bottom   border.  Hold  down  the left mouse button and drag
  683. to do a change.
  684.    To do the change with the mouse, hold down the left button and drag,
  685. then click once the right button to exit.
  686.  
  687.   With  the  keyboard,  when  selecting specifically either the move or
  688. size  option  is  possible,  one uses the cursor keys to do the change,
  689. exactly as in Windows (c).
  690.   Otherwise,  when  it is a dialog box and the ALT-SPACE command sets a
  691. global  change  mode, one uses the cursor keys to move the box, and one
  692. holds  down  the  ALT key and presses the cursor keys simultaneously to
  693. change the size.
  694.  
  695.  There are also alternate keys to change the size:
  696.  '>'  increases width
  697.  '<'  reduces width,
  698.  '+'  increases height,
  699.  '-'  reduces height.
  700.  
  701.  Press ESC or ENTER to exit.
  702.  
  703.  
  704. DISK COMMANDS
  705.  
  706. DOS  disk  commands  are  available  either  within the menu, or on the
  707. desktop.  Commands  in  the  menu are special improved built-in command
  708. or   simply  those  of  DOS, as IconShell is a shell to DOS.
  709. File  and  disk   copy,  format, use the DOS with a graphical interface
  710. to make them simple.
  711.  
  712. WHERE (Where is) Locate a filename.
  713.     Use the command 'w'.
  714.     Search   for  a  filename or pattern in a whole drive, starting
  715. at root directory.  ESC can abort the process.
  716.  Examples:   c:*.exe
  717.        or    a:FILENAME.EXE
  718.        or    FILENAME.EXE
  719.        and so on...
  720.  
  721. MD  Make a directory.
  722.     Use the command 'k'.
  723.  
  724. DEL Delete a file or an empty directory.
  725.     Use CTRL+d.
  726.  
  727. REN Rename a file or a directory or move a file in another directory.
  728.     Use 'n' and type the new name, and optionally type a new path.
  729.  
  730. LOCK Protect a file against deletion.
  731.     Use the command 'l'.
  732.     Attributes are then displayed as ASHR:
  733.       A: archive
  734.       S: system
  735.       H: hide
  736.       R: read only
  737.   Only  the  'read  only'  attribute can be changed here, for any other
  738. attribute, use the 'o' command.
  739.   Press 'l' or '+' to lock the file, 'u' or '-' to unlock it.
  740.  
  741. COPY Copy a file or a directory with its sub-directories.
  742.      Use 'y' to copy selected file or directory, then a window displays
  743. the  directories to the user selects the destination path.
  744.   One  moves to the proper path, not only one moves the cursor on a di-
  745. rectory  name,  but changes to it, then presses 'y' again to do the co-
  746. py.
  747.  
  748. DISKCOPY Copy a disk.
  749.   Type  '$'.   This command run either the DISKCOPY.BAT file if present
  750. in the IconShell directory or the MS-DOS diskcopy.com command.
  751.   DISKCOPY.BAT  holds  a  generic  program name 'diskdup' that copies a
  752. disk  in  one  pass  by  storing the disk image on a hard drive. If you
  753. don't  own  a  program of this kind, simply erase the DISKCOPY.BAT file
  754. and  the  MS-DOS  command  will  be directly called. Of course, you may
  755. edit  DISKCOPY.BAT to put another name for the one-pass duplicator, as-
  756. suming  it requires as first parameter the name of the disk to copy and
  757. as  second parameter the name of the unit to store the disk image. Some
  758. programs  use  another  syntax  and  you must deal with it to adapt the
  759. batch file.
  760.   On  may  choose the option 'DOS diskcopy' that is for a standard copy
  761. using  the  MS-DOS  diskcopy.com  program,  or 'Disk image', for a copy
  762. with a one-pass duplicator.
  763.    In both cases one selects with the Source button the disk drive that
  764. holds  the    disk  to copy. In the DOS diskcopy case, one selects with
  765. the  Target  button  the  disk drive that holds the backup disk. In the
  766. second  case, one selects with the Image button the unit where the disk
  767. image is temporary stored.
  768.  
  769. FORMAT  Format a disk.
  770.   Type 'f', then select either the drive A or B, by a press on the 'd'
  771. key,  and  select the DOS format method for a 1.44 disk:
  772. -  Certify:  this  is  the  standard format command. The DOS format the
  773. disk and verify each sector.
  774. -  Quick:  this  corresponds   to  the  /Q  option of MS-DOS than clear
  775. only the FAT and directories.
  776.  
  777.   For  other  options or other kind of disk, some examples of icons are
  778. provided Disk command desktop.
  779.  
  780. CHKDSK Checks a disk for correct allocation.
  781.    Use the icon CHECK DISK.
  782.  
  783. MEM Views memory.
  784.    Use the icon MEM from MS-DOS version 5, of CHKDSK otherwise.
  785.  
  786.   All  other  commands  of  the  DOS  manual also can be installed into
  787. icons.
  788.  
  789.  
  790. THE DESKTOP SWTOOLS
  791.  
  792.  In the shareware market, there are of new improved useful commands to
  793. enhance  the DOS.  Some examples are already typed on the SWTOOLS desk-
  794. top:
  795. - Pkunzip    (c) PKware.
  796. - Arj        (c) R.K. Jung.
  797. - Lha        (c) H. Yoshizaki.
  798. - Diskdup    (c) R. K. Snyder.
  799. - V-Scan     (c) McAffee Associates.
  800.  
  801.   Many  other  commands  may be installed in the same way, than you may
  802. find  at  shareware distributors and BBS.  These programs generally re-
  803. quire one pays a licence used them.
  804.  
  805.  
  806. TO QUIT ICONSHELL
  807.  
  808. Press    'q'    to  exit  and save options of the display (windows, co-
  809. lours,    ...)    as  they  are  not stored in the CFG file until there
  810. is  change  relating  to icons or the F2 key is pressed.
  811.  
  812. Press F3 to exit without saving last changes.
  813. Alternate keys to F3: ALT-F4, ALT-X.
  814.  
  815. To  do  a  mouse click on the diamond at right of the title bar, is the
  816. same than to press the F3 keys.
  817.  
  818.  
  819. PHANTOM FILENAMES
  820.  
  821. 'Phantom  files' are  programs integrated to IconShell, that can sit in
  822. the command or program field, as programs on disk.
  823.  
  824. There are currently:
  825.  
  826. EXIT.EXE  Its action is to return to DOS.
  827. QUIT.EXE  saves display changes and return to DOS.
  828. WAIT.EXE  waits  for  a key press. Useful when a command displays some-
  829. thing just before to exit.
  830. BOARD.EXE  with  CFG  filename  as  parameter,  allows  loading  a  new
  831. desktop.
  832. CLOCK.EXE Displays the time.
  833. DIRECTORY Shows the current disk directory in a window.
  834. CDD       Change drive and directory.
  835.  
  836. If    by  chance  one  wants  to put really program with the same names
  837. in  fields  of  icon,    or    same  names  with  'COM'  extension, one
  838. must  specify  path  (for  example: C:CDD.COM), and IconShell runs  the
  839. file   from disk rather to execute the phantom programs.
  840.  
  841.  
  842. BOARD.EXE
  843.  
  844. This  integrated  program  allows  multiple  desktop. One uses the  'a'
  845. command  to  create a new icon, fills the command field, for example:
  846.  
  847.      BOARD.EXE  C:\MYBOARD.CFG
  848.  
  849. Then  a  click on this icon display until 30 new icons. There is no li-
  850. mit  but the disk size to the number of boards. It is preferable to put
  851. the  complete path of the config file, as the icon can be selected from
  852. another sub-directory.
  853.   The  registered  version  recognizes  a second parameter to a file of
  854. icon images and a third parameter to a background picture.
  855.  
  856.  
  857. HOW TO MAKE A NEW DESKTOP
  858.  
  859. The  program    comes  with  some CFG files that contains desktop data.
  860. Creating  a new CFG file is easy and done with following steps:
  861.  
  862. 1) Add a new icon with these data in the program field:
  863.         BOARD.EXE  C:\MYBOARD.CFG
  864. BOARD.EXE  is  the 'phantom' program that loads an alternate desktop.
  865.  
  866. 2) Click twice on this new icon. An error message is displayed,
  867.   'File no found: MYBOARD.CFG'
  868. This  is normal, the  program  attempts  to load it, does not found it,
  869. then  restart  with  default  desktop. Note  than  the  name 'MYBOARD',
  870. without extension, is now displayed on the title bar.
  871.  
  872. 3) Remove the icons you don't want to keep, and add those you want.
  873.    That's all!
  874.  
  875. To  make  a  link  with  the  main desktop, you may add   an icon  with
  876. BOARD.EXE C:\SHELL.CFG in the program field.
  877.  
  878. Note  than  these  paths are only for examples, any drive and directory
  879. may rather be used.
  880.  
  881. Another  simple  method to create a new desktop is running IconShell at
  882. the  DOS  prompt with the name of the new board as parameter. A message
  883. display  "file  not found", that you ignore, and the program start with
  884. the  default  board of icons. You further save the desktop with F2, and
  885. add an icon to make the links from the main desktop to the new one.
  886.  
  887.  
  888. TO READ A TEXT FILE
  889.  
  890. To  display the content of a file on the desktop, press the 'r' key, or
  891. simply ENTER if no a file with the BAT extension.
  892. The  built-in  viewer  may  read files having 32767 lines, and up to 32
  893. megabytes.  However,  the  more  the  size increase, the more the speed
  894. slow  down,  it is in fact intended to easily read all these short text
  895. files you often find around.
  896.  
  897. Commands are these:
  898. - ESC:   exit.
  899. -  Cursor  key: scroll up or down a line, or move horizontally the win-
  900. dow on the text.
  901. - Page up: display previous screen page.
  902. - Page down: display next screen page.
  903. - HOME: jump to start of file.
  904. - END:  jump to end of text in memory.
  905.   By  a  mouse  click on a green button upon the text window one passes
  906. these same commands.
  907.  
  908.  
  909. HOW TO CREATE IMAGES FOR ICONS
  910.  
  911. The  SHELL.SPR   file  holds  33 images that are icons of commercial or
  912. shareware  softwares for DOS, or symbols of  commands,  and these icons
  913. are  loaded  or  drawn,  and  stored  in a compressed   file  with  the
  914. sprite  designer MegaSprites, which is a part of VIRTUAL REALITY TOOLS,
  915. also available in shareware.
  916.  
  917.  
  918. ABOUT THE GRAPHICAL INTERFACE
  919.  
  920. IconShell  has been written  in C and assembly 80286, using a graphical
  921. interface  that I have also written. This  interface  is   used  yet by
  922. V.  R.  Tools, HLIST and programs that are currently in work, including
  923. a  new  graphic  development  system having a new concept that probably
  924. will  comes  to  the  market  in  one or two months. By using specially
  925. written  graphical functions and with always the search of the simplest
  926. algorithm  in  mind,  I write these so short program that do so much as
  927. some commercial packages with 1/10 the size.
  928.  
  929.  
  930. THE BAT FILES
  931.  
  932. SE.BAT
  933. Purpose  of  this program  is to go to C: root directory and run SHELLR
  934. from any disk and directory.
  935. If IconShell  is  not installed on c: drive, one may edit SE.BAT and
  936. change 'c' to the proper drive letter.
  937.  
  938. DISKCOPY.BAT
  939. This  program  serves  to load either the DOS diskcopy command or a re-
  940. placing  one-pass  program  (not furnished) that stores the disk images
  941. on  a  hard  drive unit. You may edit this  file to change the name and
  942. path of programs it calls.
  943.  
  944.  
  945. ANNEX I: PROBLEMS AND OFTEN ASKED QUESTIONS
  946.  
  947. 1)  Don't  put  a  resident  program  in  the COMMAND field, as it will
  948. install  itself  in  the middle of the memory! Use the IconShell reload
  949. feature to install resident programs and return to IconShell.
  950.  
  951. 2)  If any problem appears in the IconShell display, this probably come
  952. from  a  corrupted  CFG  file,  or  a  CFG  file  that  is  for another
  953. software.  Installing IconShell config files in a special sub-directory
  954. and   setting  the  proper  paths in the icons will fix the problem.
  955.  
  956. 3)  The  version  1.8 and following are not compatible with older ones.
  957. An  attempt  to load older  CFG file will blank the screen and the pro-
  958. gram  will  hang  (this  has  no effect on user files). When installing
  959. the new version,  be careful  to erase all previous CFG files of Icon-
  960. Shell first.
  961.  
  962. 4)  Some  programs    that  are  normally  launched when one puts their
  963. name  in    the    program  field,  can't  be  loaded if one calls them
  964. within  the  command    field. When it calls a program from the command
  965. field,  IconShell  remains    resident    and  the  screen mode remains
  966. graphical.  The program can use a way to display text than  don't  work
  967. on  graphic  screen  unlike  DOS commands. It is also possible it can't
  968. fit in the available memory.
  969.  
  970. 5)  The  "Out  of memory" message may occur after you use IconShell, if
  971. you  are  loaded  directly a resident program. Look at the 1) paragraph
  972. to avoid that.
  973.  
  974.  
  975. ANNEX II: SUMMARY OF COMMAND KEYS
  976.  
  977. F1             Display the help screen.
  978. h              Display the copyright, version, date.
  979. Cursor keys    Select icon, sub-menu, etc...
  980. ESCAPE         Leave current function, window, menu, etc...
  981. ENTER          Execute a function.
  982. +              Launch a program by association with one or more
  983.                files.
  984.  
  985. SPACE BAR      Toggle to installed icons or disk directory
  986.                on the desktop.
  987. HOME           Jump to the first file.
  988. PG up/down     Scroll files on the desktop.
  989.  
  990. v or END       Show the content of an icon.
  991. i              Install currently selected file as icon.
  992. a              Add an icon.
  993. c              Change an existing icon.
  994. DEL            Remove an icon.
  995. m              Move an icon ('m' to select icon, 'm' again to
  996.                drop).
  997.  
  998. ALT+key        Get sub-menu or changes a color in desktop.
  999. o              Execute directly DOS command.
  1000. d              Show directory. (+ ENTER to run a program).
  1001. b              Set desktop directory mask.
  1002. Shift-A..F     Change drive.
  1003.  
  1004. w              Find path of a filename.
  1005. l              Lock a file.
  1006. n              Rename a file or a directory.
  1007. k              Create a new directory.
  1008. y              Copy a file, or a directory.
  1009. $              Copy a disk.
  1010. f              Format a disk.
  1011. CTRL-d         Delete selected file or directory.
  1012. r              Display a file as ASCII.
  1013.  
  1014. u              Open the setup dialog box.
  1015. F5             Open the dialog box for colors change.
  1016. F2             Save the preferences.
  1017. s              Change screen resolution.
  1018. p              Set/Reset picture for background (Reg. ver.)
  1019. ALT-SPACE      Change current window.
  1020. z              Restore standard settings.
  1021.  
  1022. q              Save changes and quit.
  1023. F3             Exit.
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.